home *** CD-ROM | disk | FTP | other *** search
/ Chip 1996 September / CHIP 1996 szeptember (CD07).zip / CHIP_CD07.ISO / drivers / asus / netware3 / netware.txt next >
Text File  |  1995-08-29  |  39KB  |  1,075 lines
  1. ********************************************************
  2.                NETWARE.TXT
  3. ********************************************************
  4.  
  5. This file describes the features and use of the Symbios Logic SDMS 
  6. device drivers for the Novell NetWare v3.12 and 4.xx operating 
  7. system environments. It is divided into the following sections:
  8.  
  9. Introduction
  10. Installing Your SDMS NetWare Drivers
  11. The Power Management Utilities
  12. Important Additional Information
  13.  
  14. ********************************************************
  15.  
  16.  
  17. ********************** Introduction ***********************
  18.  
  19. The Symbios Logic SDMS drivers for the Novell Netware operating 
  20. system allow you to utilize a Symbios Logic SCSI controller or 
  21. processor, controlled by a Symbios Logic SCSI BIOS, with NetWare. 
  22. The SDMS software, coupled with a Symbios Logic SCSI controller 
  23. or processor, provides a SCSI solution within the NetWare 
  24. environment.
  25.  
  26. Separate drivers are provided for Novell NetWare v3.12, and Novell 
  27. NetWare v4.xx. The following information explains how to install and 
  28. use the SDMS SCSI drivers for NetWare.
  29.  
  30.  
  31. * Features *
  32.  
  33. Supports the ASPI interface
  34. Provides synchronous negotiation (including fast and Fast-20 SCSI)
  35. Supports multiple host adapters
  36. Supports multiple logical unit numbers (LUN)
  37. Large LUN support (larger than 7.844 GBytes) for devices with 
  38.     dedicated NetWare partitions and volumes
  39. Supports Disconnect/Reselect
  40. Supports scatter-gather
  41. Supports tagged command queuing
  42. Supports ordered queue tags
  43. Allows shared interrupts
  44. Supports Wide SCSI (single-ended and differential)
  45. Supports device exclusion
  46. Supports NWOS2
  47. Supports NW4.10 SFT-III
  48. Supports target initiated negotiation (wide and synchronous)
  49. Displays SCSI Additional Sense Code & Qualifier bytes
  50. Support for removable media devices including CD-ROM, Magneto 
  51.     Optical, and Bernoulli devices
  52. Supports retries on non-sequential access devices
  53. Extensive error reporting and handling for multi-LUN RAID support
  54. Supports 3.XX BIOS and DOS drivers
  55. Power management supported via PMSCHED
  56.     (a power management utility)
  57.  
  58.  
  59. * Description *
  60.  
  61. There is a separate SDMS device driver and ASPI manager for each 
  62. of two major releases of NetWare. For NetWare v3.12, the SDMS 
  63. device driver is SDMSNET3.DSK, and the file NETASPI3.NLM is 
  64. loaded if support for the ASPI interface is desired (this is required 
  65. for devices such as tape drives). For NetWare v4.xx, the SDMS 
  66. device driver is SDMSNET4.DSK, and the file NETASPI4.NLM is 
  67. loaded if support for the ASPI interface is desired.
  68.  
  69.  
  70. * ASPI Support *
  71.  
  72. The Symbios Logic ASPI interface is provided by the NETASPIx.NLM
  73. drivers. NetWare, or third party applications, may use this interface to 
  74. communicate with any SCSI-2 device attached to a Symbios Logic 
  75. controller, including SCSI-2 tape devices.
  76.  
  77.  
  78. ************ Installing Your SDMS NetWare Drivers ************
  79.  
  80. Install NetWare as described in the Novell NetWare Installation 
  81. Manual. The following information is provided to assist in the 
  82. installation.
  83.  
  84. You can load these drivers only once. If changes are required 
  85. (to reconfigure the driver options), you must remove the drivers and 
  86. reload them with the new option settings. If these changes are 
  87. permanent, and the drivers load automatically at server boot time, you 
  88. must specify these options in the startup.ncf or autoexec.ncf file.
  89.  
  90.  
  91. * For An Existing Installation Of NetWare 
  92.     With SDMS Drivers Installed *
  93.  
  94. If your current SDMS NetWare drivers are version 3.05.00 or older, 
  95. they are named NCRSDMSx.DSK and ASPICAMx.NLM. Replace 
  96. the NCRSDMSx.DSK and ASPICAMx.NLM drivers with the ones 
  97. supplied on the new Symbios Logic device drivers diskette.
  98.  
  99. If you intend the driver to auto load on NetWare boot, it is necessary 
  100. to edit the startup.ncf or autoexec.ncf file and replace the line:
  101.  
  102. LOAD NCRSDMSx.DSK <options>
  103.  
  104. with
  105.  
  106. LOAD SDMSNETx.DSK <options>
  107.  
  108. where x is the version of NetWare you are using, and <options> are 
  109. the command line options (if any) you intend to use.
  110.  
  111. If your current SDMS NetWare drivers are version 3.06.00 or newer, 
  112. they are named SDMSNETx.DSK and NETASPIx.NLM. Replace 
  113. the SDMSNETx.DSK and NETASPIx.NLM drivers with the ones 
  114. supplied on the new Symbios Logic device drivers diskette. 
  115.  
  116. No other actions are required to use these new drivers. You may want 
  117. to review the command line options to insure you are using the best 
  118. options for your configuration.
  119.  
  120.  
  121. * For NetWare v3.12 New Installations *
  122.  
  123. Note:
  124. The SDMSNET3.DSK driver should work on a NetWare 3.11 server. 
  125. However, this compatibility is neither tested nor supported.
  126.  
  127. 1. Create a directory in which to install the NetWare file server. 
  128. Change to that directory and copy all the files from the NetWare 
  129. system disks into that directory.
  130.  
  131. 2. Copy the file SDMSNET3.DSK from the Symbios Logic device 
  132. drivers diskette into this directory. If ASPI support is desired, also 
  133. copy NETASPI3.NLM. 
  134.  
  135. 3. To start NetWare and continue the installation, type:
  136.  
  137.     SERVER
  138.  
  139. 4. When prompted, enter the name of the file server and 
  140. network (IPX) number. See the chapter on file server installation 
  141. in the NetWare Installation Manual for restrictions and further 
  142. information.
  143.  
  144. 5. At the NetWare prompt, type:
  145.  
  146.     LOAD SDMSNET3 <options>
  147.  
  148. This command causes the main driver to be loaded. Without this 
  149. command, NetWare is unable to access the hard disk drive. If ASPI 
  150. support is desired, also type:
  151.  
  152.     LOAD NETASPI3
  153.  
  154. 6. To bring up the Installation menu, at the NetWare prompt type:
  155.  
  156.      LOAD INSTALL
  157.  
  158. Continue with the installation according to the file server installation 
  159. chapter in the Novell NetWare Installation Manual.
  160.  
  161. 7. At the Available System Options menu, select the 
  162. EDIT STARTUP.NCF option and check to see that the line 
  163. LOAD SDMSNET3 is in the file. If not, add this line to the file. 
  164. This eliminates the need to load drivers by hand every time the system 
  165. is powered up. If the line appears more than once, remove the duplicate 
  166. statements and all references to "port=xxxx", "slot=xxxx" and/or 
  167. "mem=xxxx".
  168.  
  169. 8. In addition, if ASPI support is required, add the line:
  170.  
  171.     load NETASPI3.NLM
  172.  
  173. to the file after the line:
  174.  
  175.     load SDMSNET3.DSK
  176.  
  177.  
  178. * For NetWare v4.xx New Installations *
  179.  
  180. 1. Begin the file server installation as per the instructions in the file 
  181. server installation chapter in the Novell NetWare Installation Manual. 
  182.  
  183. 2. When the NetWare installation procedure prompts you for a Disk 
  184. Driver, insert the Symbios Logic device drivers diskette into 
  185. drive a: or b:. Then use the INS key to select an unlisted driver. A 
  186. dialog box appears. If you are installing the driver from the a: drive, 
  187. press Enter to continue. If you are installing the driver from the 
  188. b: drive, press F3 (to specify the path to search for the driver), and 
  189. enter the drive letter: 
  190.  
  191.     B:
  192.  
  193. The SDMSNET4.DSK driver should appear as a selection. 
  194. Select the driver.
  195.  
  196. 3. Next you are prompted with the available command line options 
  197. to load the driver. A description of each option will appear in the 
  198. ]box at the bottom of the installation screen. A more detailed 
  199. description is also given later in this document, in the section titled 
  200. Command Line Options. Select any options needed for your 
  201. particular installation.
  202.  
  203. 4. When asked to edit the STARTUP.NCF file, make sure 
  204. SDMSNET4 is loaded only once. If present, remove the 
  205. "port=xxxx slot=xxxx mem=xxxx" options from the command line.
  206.  
  207. 5. After the installation is complete, if ASPI support is also desired, 
  208. down the server and copy the NETASPI4.NLM file to the appropriate 
  209. server directory. For NetWare 4.0x systems this directory is 
  210. SERVER.40 by default. For NetWare 4.1x systems this directory is 
  211. NWSERVER by default.
  212.  
  213. Edit the startup.ncf file and add the line:
  214.  
  215.     load NETASPI4.NLM
  216.  
  217. to the file after the line:
  218.  
  219.     load SDMSNET4.DSK
  220.  
  221.  
  222. * For NetWare v4.1x SFT-III Installations *
  223.  
  224. 1. Install your primary server following procedures for native 4.1x 
  225. installations.
  226.  
  227. 2. Begin the SFT-III installation as instructed by NetWare installation 
  228. procedures.
  229.  
  230. 3. While installing the secondary server, you have the option of 
  231. copying the SDMSNET4.DSK driver from the primary server. 
  232. Press F10 to accept.
  233.  
  234. 4. If ASPI support is required for the secondary server, down the 
  235. system after completing the SFT-III installation.
  236.  
  237. Copy the NETASPI4.NLM file from the device drivers diskette to 
  238. the NWSERVER directory on the secondary server.
  239.  
  240. Edit the IOSTART.NCF file on both servers by adding the line:
  241.  
  242.     load NETASPI4.NLM
  243.  
  244. to the files after the line:
  245.  
  246.     load SDMSNET4.DSK
  247.  
  248.  
  249. * For NetWare v4.1x NWOS2 Installations *
  250.  
  251. You may have NetWare for OS/2 (NWOS2) configured in one of the 
  252. two following ways:
  253.  
  254.  
  255. Typical Configuration
  256.  
  257. The OS/2 operating system is installed on a device which is controlled 
  258. by the Symbios Logic OS2CAM.ADD driver, and/or the Symbios 
  259. Logic OS2CAM.ADD driver is loaded by OS/2. 
  260.  
  261. In this case, you must not load the Symbios Logic SDMSNET4.DSK 
  262. driver. When prompted for a disk driver during installation of 
  263. NWOS2, accept the Novell provided default driver DSKSHARE.DSK.
  264. Refer to the NetWare documentation for more information about this 
  265. driver.
  266.  
  267.  
  268. Novell Certified Configuration
  269.  
  270. The OS/2 operating system is installed on a device which is not 
  271. controlled by a Symbios Logic PCI controller (for example, an IDE 
  272. drive), and the Symbios Logic OS2CAM.ADD driver is not loaded 
  273. on the OS/2 server.
  274.  
  275. In this case, you may load the SDMSNET4.DSK driver and 
  276. associated utilities. The steps for loading the driver are listed below.
  277.  
  278. 1. Make sure the Symbios Logic OS2CAM.ADD driver is not loaded.
  279.  
  280. 2. Follow the NWOS2 installation procedure provided by Novell.
  281.  
  282. 3. When prompted for a disk driver, do not accept the Novell 
  283. provided default driver DSKSHARE.DSK. Pick the option to "Select 
  284. additional or modify selected Disk/LAN drivers" from the pick list.
  285.  
  286. 4. Choose "Unload a selected driver" and delete the 
  287. DSKSHARE.DSK driver.
  288.  
  289. The DSKSHARE.DSK driver may state that it is not currently loaded.
  290. Perform the deletion anyway.
  291.  
  292. 5. Select "Load an additional driver" from the pick list. 
  293. Insert the Symbios Logic device drivers diskette into drive a: or b:. 
  294. Use the INS key to select an unlisted driver. A dialog box appears. 
  295. If you are installing the driver from the a: drive, press Enter to 
  296. continue. If you are installing the driver from the b: drive, press F3 
  297. (to specify the path to search for the driver), and enter the drive letter. 
  298. The SDMSNET4.DSK driver should appear as a selection. Select the 
  299. driver.
  300.  
  301. 6. Continue with step three for NetWare v4.x new installations.
  302.  
  303.  
  304. * Command Line Options *
  305.  
  306. The SDMSNET3.DSK and SDMSNET4.DSK drivers have many 
  307. tuning parameters. Following is a list of tuning parameters available, 
  308. including the default option and a list of valid options. Following 
  309. each parameter is a description of when to use a parameter, and any 
  310. impact its use/disuse might incur.
  311.  
  312. If an option is specified but the assignment is not valid, then the 
  313. default value is used. The SDMSNET3.DSK and SDMSNET4.DSK 
  314. drivers are referred to in the remainder of this section as 
  315. SDMSNETx.DSK, where x refers to the appropriate NetWare 
  316. operating system version.
  317.  
  318. The options described below are used by placing the specified 
  319. characters on the load command line for the SDMS driver. For 
  320. example, if the Verbose Mode command line option is desired in 
  321. NetWare 3.1X, the load command line should look like this:
  322.  
  323.     load SDMSNET3 -v
  324.  
  325. IMPORTANT:
  326. No spaces are allowed in specifying these command line options. 
  327. Spaces are required between different command line options.
  328.  
  329.  
  330. Using the Verbose Mode Option 
  331.  
  332. Command line option:    -v 
  333. Function:       Display the current settings of 
  334.     all driver options.
  335. This option shows all the command line option settings for this load 
  336. of the driver.
  337.  
  338.  
  339. Using the Help Mode Option 
  340.  
  341. Command line option:    -? or -h 
  342. Function:       Display the options available in 
  343.     the driver. 
  344. Possible Impact:        The driver will not load with -? 
  345.     or -h specified.
  346. This option is specified on the command line for a brief description 
  347. of each of the options available in the driver, as well as valid values 
  348. for each option. If the -? or -h option is specified along with other 
  349. options, the help screen is invoked, the other options are ignored, 
  350. and the driver is not loaded.
  351.  
  352.  
  353. Using the Tagged Queuing Option 
  354.  
  355. Command line option:    qtags=<option>
  356. Default value:  enable
  357. Valid options:  enable, disable
  358. Function:       Enable/disable tagged 
  359.     queuing for the devices 
  360. Possible Impact:        Tagged queuing may result in 
  361.     improved I/O throughput in 
  362.     devices that support such an 
  363.     option.
  364. Enabling this option results in the driver issuing tagged IO requests 
  365. to the devices that support tagged queuing. Devices that do not 
  366. support tagged queuing are not issued tagged requests. Depending 
  367. on the drive controller, throughput of the device is increased by the 
  368. use of queue tags. However, the optimal number of queue tags is 
  369. based on the specific device type.
  370.  
  371.  
  372. Using the Depth of Queue Tags Option
  373.  
  374. Command line option:    qdepth=<option>
  375. Default value:  10
  376. Valid options:  0-128
  377. Function:       Set the depth of the queue for 
  378.     tagged queuing. This 
  379.     value designates the depth of the 
  380.     queue per LUN (I_T_L
  381.     nexus). That is, this value
  382.     designates the depth of the
  383.     queue per device, or per LUN, if
  384.     a device has multiple LUNs.
  385. Possible Impact:        Used to optimize the 
  386.     performance of tagged queuing.
  387. This option is valid only when tagged queuing (qtags) is enabled, 
  388. which it is by default. Values possible for this parameter range 
  389. from 0 to 128. 0 is equivalent to qtags=disable. While the actual 
  390. depth of the queue depends on the specific drive controller, for 
  391. single drives values of about 10-30 are typically optimal. 
  392. A greater number may be optimal for peripherals such as disk arrays. 
  393. You should experiment with various qdepth values to determine the 
  394. optimal performance for their particular setup. The optimal qdepth 
  395. value is based on different aspects of the system, including but not 
  396. limited to: the processor, the available memory, the disk drives, and 
  397. other peripherals.
  398. Note:
  399. The driver supports a maximum of 128 qtags per controller at a 
  400. given time. The driver may allocate fewer qtags per device if this 
  401. limit is being reached.
  402.  
  403.  
  404. Using the Queue Tag Type Option
  405.  
  406. Command line option:    qtag_type=<option>
  407. Default value:  simple
  408. Valid options:  simple, ordered
  409. Function:       Specify the type of tagged 
  410.     commands the device is
  411.     issued.
  412. Possible Impact:        Ordered type is required 
  413.     for certain devices to avoid 
  414.     IO starvation.
  415. This option is valid only when tagged queuing (qtags) is enabled, 
  416. which it is by default. Simple qtags are typically the preferred tag 
  417. type. It is sometimes necessary to use ordered tags on certain 
  418. devices to avoid IO starvation under extremely heavy IO loads 
  419. such as a NetWare remirror process.
  420.  
  421.  
  422. Using the Base Time-Out Option
  423.  
  424. Command line option:    timeout=<option>
  425. Default value:  30 
  426. Valid options:  Any integer value 30 to 
  427.     999999999 
  428. Function:       Specify the minimum value (in 
  429.     seconds) for command 
  430.     time-out.
  431. Possible Impact:        Insure system integrity when 
  432.     using a slow device. 
  433. If a device is slow, you should increase this value to insure the device 
  434. has adequate time to respond to a command issued to it before the 
  435. command times out.
  436.  
  437.  
  438. Using the Sorting of Read Requests Option 
  439.  
  440. Command line option:    sort=<option> 
  441. Default value:  enable 
  442. Valid options:  enable, disable 
  443. Function:       Enable/disable sorting of read 
  444.     commands to be issued to 
  445.     devices. 
  446. Possible Impact:        Enabling will normally yield 
  447.     increased performance based 
  448.     on the target device controller.
  449. If the devices connected to the host adapter(s) are of a non-buffered 
  450. architecture, such as the Symbios Logic 6298 disk array, then sorting 
  451. of reads may result in a performance degradation, since the absence 
  452. of cache provides no benefit for sorted requests. In this instance you 
  453. should disable the sort option. On most disk drives, an on-board cache 
  454. allows for reading ahead of data, and by sorting read requests, the 
  455. probabilities of achieving a cache hit are greatly increased, thus 
  456. increasing the overall performance of the driver.
  457.  
  458.  
  459. Using the Shared Interrupts Option
  460.  
  461. Command line option:    shared_int=<option>
  462. Default value:  disable
  463. Valid options:  enable, disable
  464. Function:       Support shared interrupts.
  465. Possible Impact:        Enabling may cause a 
  466.     performance degradation.
  467. You should enable the shared interrupt option any time a PCI card 
  468. other than a Symbios Logic controller is added to a system which 
  469. assigns all PCI cards the same interrupt value. The added card must 
  470. support shared interrupts. The driver automatically handles the case 
  471. of more than one Symbios Logic host adapter sharing an interrupt.
  472.  
  473.  
  474. Using the Wide SCSI Option
  475.  
  476. Command line option:    wide=<option>
  477. Default value:  enable
  478. Valid options:  enable, disable
  479. Function:       Enable/Disable support of 
  480.     wide SCSI.
  481. Possible Impact:        No wide SCSI support 
  482.     available.
  483. This option allows the user to disable support of wide SCSI when 
  484. using a wide SCSI controller. Set this option to ╥disable╙ if a wide 
  485. SCSI device is present on the system, but a narrow SCSI cable is 
  486. connected somewhere on the bus between the wide SCSI host adapter 
  487. and the wide device, thus prohibiting the transfer of wide data. If this 
  488. option is set to ╥disable╙, the wide device will still work, but all 
  489. data transferred to/from the device is narrow (8 bit). The driver will 
  490. not initiate a wide SCSI transfer request negotiation.
  491.  
  492.  
  493. Using the Number of Error Recovery Retries Option
  494.  
  495. Command line option:    max_retry=<option>
  496. Default value:  5
  497. Valid options:  0-50
  498. Function:       Set the maximum limit on the 
  499.     number of times to retry an 
  500.     IO on a non-sequential access 
  501.     device in the event of a SCSI 
  502.     error condition.
  503. Possible Impact:        Setting this to 0 prevents the 
  504.     driver from retrying an IO in 
  505.     the event of an error.
  506. If SCSI error conditions occur on a non-sequential access device, the 
  507. driver retries an IO operation the set number of times before giving 
  508. up and returning the IO to the caller with a failed status. Possible 
  509. callers are NetWare or an application via the CAM or ASPI interface. 
  510. If this option is set to 0, IOs are not retried in the event of an error 
  511. condition.
  512. Note:
  513. Some SCSI error conditions (such as DATA PROTECT or 
  514. ILLEGAL REQUEST) do not warrant a retry. Such conditions are 
  515. reported but not retried, even for positive values of max_retry.
  516.  
  517.  
  518. Using the Logging of SCSI Errors Option
  519.  
  520. Command line option:    Log_ScsiErrors=<option>
  521. Default value:  Both
  522. Valid options:  Off/Console/Syslog/Both
  523. Function:       Specify where to log serious 
  524.     SCSI errors.
  525. Possible Impact:        Changing this option may result 
  526.     in loss of this information.
  527. If SCSI error conditions occur, the driver normally attempts to log a 
  528. SCSI Error Report describing the event to both the console and the 
  529. system log file SYS:SYSTEM\SYS$LOG.ERR. This information is 
  530. valuable in determining when a device is having problems. It can 
  531. indicate when a device is beginning to fail, providing an 
  532. opportunity to replace the device before complete failure.
  533. With this option you can choose to specify where these messages 
  534. are logged: Console - the server console only; Syslog - the system 
  535. error log; Both - both the server console and the system error log; 
  536. or Off - the error messages are not logged anywhere.
  537. Note:
  538. This option affects the logging of serious SCSI errors only. 
  539. Non-SCSI errors are still logged to both the console and system 
  540. error log.
  541.  
  542.  
  543. Using the Exclusion of Devices Option
  544.  
  545. Command line option:    xcl=<device>[:device ...]
  546. Default value:  All devices recognized by the 
  547.     driver, i.e. no devices are
  548.     excluded.
  549. Valid options:  p,i,l 
  550.     (Multiple devices may be 
  551.     specified with a colon separator)
  552.     where p is the Path designator, 
  553.     and is in the range 0 -7, i is
  554.     the SCSI ID designator, and is 
  555.     in the range 0 -31, l is the
  556.     LUN designator, and in the 
  557.     range 0 -7. The LUN parameter 
  558.     is optional. Multiple devices 
  559.     may be excluded so long as the 
  560.     string does not exceed 35 
  561.     characters in length and devices 
  562.     are separated by colons. 
  563. Examples:       xcl=1,2,3 to exclude LUN 3 of the 
  564.     device at SCSI ID 2 on Path 1.
  565.     xcl=1,2,3:2,5 to exclude LUN 
  566.     3 of the device at SCSI ID 2
  567.     on Path 1, and all LUNs on the 
  568.     device at SCSI ID 5 on Path
  569.     2 
  570. Function:       Allows for specifying certain 
  571.     devices not be recognized by
  572.     the driver.
  573. Possible Impact:        Cannot directly 
  574.     access device(s) via the 
  575.     SDMSNETx.DSK driver.
  576. This option is available to exclude specific devices from being 
  577. recognized and directly accessed by the SDMSNETx.DSK drivers. 
  578. These excluded devices are not registered with the operating 
  579. system for use by the driver. Other applications/drivers can then 
  580. take over the control of such devices. This option is available for 
  581. support of third party vendors who write their own SCSI control 
  582. applications. You may exclude a maximum of five devices.
  583.  
  584.  
  585. Using the Maximum Block Size for Concatenation Option 
  586.  
  587. Command line option:    max_kb=<option> 
  588. Default value:  32767 
  589. Valid options:  0-32767 
  590. Function:       Set the maximum number of 
  591.     KB that may be written to disk 
  592.     at one time. 
  593. Possible Impact:        A high number may result in 
  594.     more data transferred in 
  595.     a single data phase.
  596. Specify the maximum size block in Kilobytes which is written to disk 
  597. in one data transfer phase. This ensures that when requests are 
  598. concatenated, the maximum size of the concatenated request does 
  599. not exceed the specified value. If individual requests are greater than 
  600. this specified value, no action is taken.
  601.  
  602.  
  603. Note:
  604. The following three options affect the amount of memory used by the 
  605. driver. For information on how memory is allocated by the driver, 
  606. and to get an approximate feel for the amount of memory which is 
  607. saved by invoking these parameters, refer to Memory Allocation 
  608. under Important Additional Information at the end of this section.
  609. If the product of max_hbas * max_id * max_lun is small 
  610. (less than 100), system performance may suffer. These values 
  611. determine the number of IO buffers allocated by the driver. 
  612. Allocation of too few may degrade performance
  613.  
  614.  
  615. Using the Maximum Host Adapters Option
  616.  
  617. Command line option:    max_hbas=<option>
  618. Default value:  8
  619. Valid options:  1-8
  620. Function:       Specify the maximum number 
  621.     of host adapters to support.
  622. Possible Impact:        If number is reduced, may allow 
  623.     for reduction in memory
  624.     used by the driver. Reduction
  625.     may also result in performance 
  626.     degradation.
  627. This parameter is used to optimize the use of dynamically allocated 
  628. memory by the driver. If your system has less than 8 Symbios Logic 
  629. based PCI host adapters, including any Symbios PCI-SCSI controllers 
  630. designed into the mainboard, this parameter allows you to reduce the 
  631. total memory used for the driver.
  632.  
  633.  
  634. Using the Maximum SCSI IDs Option
  635.  
  636. Command line option:    max_id=<option>
  637. Default value:  32
  638. Valid options:  8-32
  639. Function:       Specify the maximum number 
  640.     of SCSI IDs each host adapter 
  641.     board should support.
  642. Possible Impact:        If number is reduced, may allow 
  643.     for reduction in memory used 
  644.     by the driver. Reduction
  645.     may also result in performance 
  646.     degradation.
  647. This parameter is used to optimize the use of dynamically allocated 
  648. memory by the driver. If all the host adapters, including any SCSI 
  649. controllers on the mainboard are connected to less than 31 devices, 
  650. you can reduce the size of the dynamically allocated memory by 
  651. setting this value to the maximum number of devices on any of the 
  652. SCSI controllers. 
  653.  
  654.  
  655. Using the Maximum LUNs Option
  656.  
  657. Command line option:    max_lun=<option>
  658. Default value:  4
  659. Valid options:  1-8
  660. Function:       Specify the maximum number 
  661.     of LUNs each host adapter
  662.     board should support per 
  663.     SCSI id.
  664. Possible Impact:        If number is reduced, may allow 
  665.     for reduction in memory used 
  666.     by the driver. Reduction
  667.     may also result in performance 
  668.     degradation.
  669. Use this parameter to optimize the use of dynamically allocated 
  670. memory by the driver. If less than 8 LUNs are used per Symbios 
  671. Logic based PCI host adapter SCSI id, this parameter allows a 
  672. reduction in the total memory used for the driver. 
  673.  
  674.  
  675.  
  676. ************** The Power Management Utilities **************
  677.  
  678. Power management support for NetWare is provided by two NLMs, 
  679. PMMAKE.NLM and PMSCHED.NLM. Use one or both of these 
  680. NLMs to activate power management of disk devices registered with 
  681. the Netware operating system through the SDMSNETx.DSK driver.
  682.  
  683. PMSCHED.NLM allows manual control of power management to 
  684. individual devices, while PMMAKE.NLM allows creation of a 
  685. schedule for power management. You must not load these two 
  686. utilities at the same time. If you plan to use power management 
  687. regularly, you can have PMSCHED.NLM load from the 
  688. AUTOEXEC.NCF file.
  689.  
  690. SDMS power management is supported only on disk devices. Some 
  691. disk devices do not support power management. If such a device is 
  692. detected, PMSCHED indicates the device is not power manageable.
  693. Command line options for the PMMAKE.NLM and 
  694. PMSCHED.NLM utilities are described in this document.
  695.  
  696. Note:
  697. Power management of disk devices connected to Symbios Logic 
  698. 8XX controllers and handled by SDMSNETx.DSK is NOT 
  699. supported in the NetWare 4.10 SFT-III environment.
  700.  
  701.  
  702. * Installing the Power Management Utilities *
  703.  
  704. Follow these steps to install the Power Management Utilities.
  705.  
  706. 1. Copy PMMAKE.NLM and PMSCHED.NLM to the 
  707. SYS:\SYSTEM directory of the NetWare server.
  708.  
  709. 2. Create a subdirectory called SYS:\PM. This is the directory in 
  710. which the schedule text and configuration files should reside.
  711.  
  712.  
  713. * Using the PMMAKE.NLM Utility *
  714.  
  715. The PMMAKE.NLM utility is used to compile a power management 
  716. schedule file from a standard text file, which you can create using the 
  717. NetWare EDIT utility, or some other editor. Place the text file in the 
  718. SYS:\PM directory on the server. The format for this text file is 
  719. given below.
  720.  
  721. The syntax for the line that loads the PMMAKE utility is:
  722.  
  723.     load PMMAKE <input filename> [<output filename>]
  724.  
  725. where
  726.  
  727. <input filename> is the full path name of the text file containing the 
  728. power management scheduling directives. If the path is not specified, 
  729. the NetWare search path is used.
  730.  
  731. <output filename> is the full path name of the output configuration 
  732. (CFG) file produced. If the output file name is not specified, the 
  733. output file produced is named PM.CFG, located in the SYS:\PM 
  734. directory.
  735.  
  736. The format for the PMMAKE input (text) file is:
  737.  
  738. !<DAY INDICATOR>
  739. BEGIN, <START TIME>, <DELAY TIME>, <DEVICE LIST>
  740. END, <STOP TIME>, <DELAY TIME>, <DEVICE LIST>
  741.  
  742. where
  743.  
  744. DAY INDICATOR = SUN,MON,TUE,WED,THR,FRI,SAT
  745. START TIME = 24 hour time format: 00:00 - 23:59
  746. STOP TIME = 24 hour time format: 00:00 - 23:59
  747. DELAY TIME = Time to wait during no activity on a device 
  748.     before spinning it down, in seconds 1 - 3600
  749. DEVICE LIST = ALL or <DEVICE ID>[, <DEVICE ID> ...]
  750. DEVICE ID = BXXIXXLXX
  751.     BXX identifies the bus
  752.     IXX identifies the SCSI ID
  753.     LXX identifies the LUN (if zero you can omit)
  754. You may omit bus identifiers after the first one. It is assumed that 
  755. multiple sequential directives are on the same day until another day 
  756. is specified. It is assumed that future devices are on the same bus 
  757. until a new bus id is specified.
  758.  
  759. For example:
  760.  
  761. B00I01L01, I02, I03, I04, B01I00, I01,I02
  762.  
  763. specifies
  764.  
  765. Devices ID 01 LUN 01, ID 2, ID 3, ID 4 on Bus 0
  766. Devices ID 0, ID1, ID 2 on Bus 1
  767.  
  768.  
  769. Here is a PMMAKE sample input file:
  770.  
  771. !SUN
  772. BEGIN, 00:00, 10, ALL
  773. END, 23:59, 10, ALL
  774. !MON
  775. BEGIN, 00:00, 10, ALL
  776. END, 06:00, 10, B00I00
  777. END, 06:30, 10, B00I01
  778. BEGIN, 18:00, 10, ALL
  779. END, 23:59, 10, ALL
  780. !FRI
  781. BEGIN, 00:00, 10, ALL
  782. END, 06:00, 10, B00I00
  783. END, 06:30, 10, B00I01
  784. BEGIN, 17:30, 10, B00I01
  785. BEGIN, 18:00, 10, B00I00
  786. END, 23:59, 10, ALL
  787. !SAT
  788. BEGIN, 00:00, 10, ALL
  789. END, 23:59, 10, ALL
  790.  
  791.  
  792. * Using the PMSCHED.NLM Utility *
  793.  
  794. You must load the PMSCHED.NLM utility to activate power 
  795. management for devices controlled by the SDMSNETx.DSK driver.
  796.  
  797. The syntax for the line that loads the PMMAKE utility is:
  798.  
  799.     load PMSCHED [<schedule file>]
  800.  
  801. where
  802.  
  803. <schedule file> is the name of the power management configuration 
  804. file to use. If no file is specified, PMSCHED looks for 
  805. SYS:\PM\PM.CFG. If PM.CFG is not found, PMSCHED loads 
  806. for manual operation of power management.
  807.  
  808.  
  809. Manual Operation
  810.  
  811. In manual operation, power management is initially off on all devices, 
  812. and gather/displaying of device statistics is on. PMSCHED.NLM 
  813. allows manual enabling and disabling of power management on 
  814. individual drives. You can also enable and disable statistics gathering, 
  815. and clear statistics.
  816.  
  817. To toggle power management on and off for a device, highlight the 
  818. device under PMSCHED.NLM and press the F3 key. A menu appears 
  819. with these selections:
  820.  
  821. 1. Toggle Power Management
  822. 2. Toggle Statistics
  823. 3. Reset Statistics
  824.  
  825. Highlight Toggle Power Management and press Enter. Toggling Power 
  826. Management has no effect on the device statistics.
  827.  
  828.  
  829. Scheduled Operation
  830.  
  831. Automatic scheduling of power management cycles is possible only 
  832. when PMSCHED remains loaded. For scheduled operation, 
  833. PMSCHED.NLM requires either:
  834.  
  835. the file SYS:\PM\PM.CFG, created by PMMAKE.NLM, or 
  836.  
  837. the name of the schedule file, created by PMMAKE.NLM, loaded 
  838. with PMSCHED as a command line parameter
  839.  
  840.  
  841. Unloading the PMSCHED.NLM Utility
  842.  
  843. Unloading PMSCHED.NLM does not turn power management off. 
  844. The state of power management on each device is maintained until 
  845. the server is downed or PMSCHED.NLM is reloaded
  846.  
  847.  
  848. Device Statistics
  849.  
  850. Device statistics are gathered on all devices registered by 
  851. SDMSNETx.DSK with the NetWare operating system. These 
  852. statistics record the number of reads and writes performed on a 
  853. device and, if the device is power manageable by the SDMS driver, 
  854. the number of times the device is spun up and spun down. Statistics 
  855. are viewed, toggled on and off, or reset from the power management 
  856. utility PMSCHED.NLM.
  857.  
  858.  
  859. ************** Important Additional Information **************
  860.  
  861.  
  862. * For Information Pertaining to a Specific Driver *
  863.  
  864. This document addresses options available on the Symbios Logic 
  865. SDMS NetWare drivers, version 3.06.00. For information pertaining 
  866. to a specific driver, please do one of the following:
  867.  
  868. - For NetWare version 4.XX, consult the SDMSNET4.DDI file for 
  869. options available for SDMSNET4.DSK. This is accessed via the 
  870. NetWare install utility.
  871.  
  872. - For versions of the driver 3.05.00 and later, use the -? option on 
  873. the command line of the SDMSNETx.DSK driver
  874.  
  875.  
  876. * About Memory Allocation *
  877.  
  878. The driver allocates memory for certain structures based upon the 
  879. maximum number of SCSI IDs (max_id), LUNs (max_lun), and 
  880. paths (max_hbas) that are used in the system. The amount of memory 
  881. allocated is based on the following formula:
  882.  
  883. 414 bytes of memory are allocated for the structure, so
  884.  
  885. Memory Allocated = 414 * max_hbas * max_lun * max_id.
  886.  
  887. So for default allocations, the amount of memory allocated is:
  888.  
  889. Memory Allocated = 414 * 8 * 4 * 32 = 423,936 bytes (414 KB).
  890.  
  891. If, for example,
  892.  
  893. - only one host adapter is installed (or when using a Symbios Logic 
  894. based PCI SCSI embedded controller and no add-in host adapters),
  895.  
  896. - only one LUN per device is used, and
  897.  
  898. - the bus is narrow (up to 8 SCSI IDs),
  899.  
  900. then by setting the appropriate command line options, the amount of 
  901. memory allocated is:
  902.  
  903. Memory Allocated = 414 * 1 * 1 * 8 = 3,312 bytes (3.4 KB).
  904.  
  905.  
  906. * Optimal Use of Command Line Options *
  907.  
  908. Peripheral Device Dependent Optimizations
  909.  
  910. Some devices support SCSI tagged queue commands very efficiently, 
  911. while others show a significant loss of performance when the number 
  912. of queued requests exceed a certain value. (qtags, qdepth, qtag_type)
  913.  
  914. Most disk drives have an onboard read cache that is used by the drive 
  915. controller to read ahead data. The driver may take advantage of this 
  916. cache by maximizing the cache hits and ensuring a higher data 
  917. transfer rate. However, there are devices that do not have an on 
  918. board cache, and implementation of the sorting algorithm results 
  919. in greater processing overhead and loss of overall performance. (sort)
  920.  
  921. Devices differ in their response times to requests. To ensure that the 
  922. driver can handle devices with various response times, an option to 
  923. tune the time-out value is available. (timeout)
  924.  
  925.  
  926. Flexibility
  927.  
  928. In order to allow flexibility in controlling devices in a system, an 
  929. option is provided to determine which devices the driver needs to 
  930. exclude from taking over control. This allows independent software 
  931. vendors to provide value added applications to directly control 
  932. certain devices through the ASPI or CAM interface. (xcl)
  933.  
  934. Serious SCSI errors are logged to both the console and system error 
  935. log by default. If a device is going bad, these errors may provide 
  936. forewarning to replace the device before complete failure. 
  937. However, you may turn off the logging of these errors to either or 
  938. both of these locations. (Log_ScsiErrors)
  939.  
  940. For embedded systems, or other systems with fixed configurations, 
  941. you can limit the amount of dynamically allocated memory by 
  942. choosing to set maximum limits on the number of host adapters, 
  943. devices, and logical units to support. The number of allocated 
  944. buffers for processing IOs is reduced, which could adversely affect 
  945.  
  946.  
  947. Overall System Timing
  948.  
  949. A driver designed for a networked file server environment has to 
  950. optimize performance in tandem with the other components of the 
  951. system. To avoid monopoly on the I/O bus, you can configure the 
  952. size of the blocks for transfer across the SCSI bus. This ensures 
  953. that other components get fair access to the I/O bus. (max_kb)
  954.  
  955.  
  956. * DOS Access Dependencies *
  957.  
  958. NetWare sometimes requires access to the DOS partition (perhaps to 
  959. load a file, or to down the system). The SDMSNETx.DSK driver 
  960. supports several SDMS DOS configurations. 
  961.  
  962. SDMSNETx.DSK detects whether an SDMS 3.XX or 4.XX BIOS 
  963. is present. If an SDMS 3.XX BIOS is present, the driver also 
  964. detects whether any SDMS DOS CAM driver is loaded.
  965.  
  966. If there are DOS partitions present on any device connected to a 
  967. Symbios Logic controller, an SDMS 3.XX BIOS is required for 
  968. DOS support. The BIOS is either integrated into the system BIOS 
  969. or resides with the controller itself.
  970.  
  971.  
  972. * Supported DOS Configurations *
  973.  
  974. The following are the DOS configurations supported by the 
  975. SDMSNETx.DSK driver:
  976.  
  977.     3.XX BIOS, DOSCAM.SYS
  978.     3.XX BIOS, MINICAM.SYS
  979.     3.XX BIOS, DOSCAM.SYS, CDROM.SYS, MSCDEX.EXE
  980.     3.XX BIOS, MINICAM.SYS, CDROM.SYS, MSCDEX.EXE
  981.     3.XX BIOS, No DOS Drivers
  982.  
  983.  
  984. * When Using An SDMS 3.XX BIOS *
  985.  
  986. If an SDMS 3.XX BIOS is present, you may load an optional 
  987. Symbios Logic CAM driver (DOSCAM.SYS or MINICAM.SYS
  988. in the CONFIG.SYS file. An optional driver for CD-ROM support 
  989. (CDROM.SYS) works with these drivers in conjunction with 
  990. MSCDEX.EXE.
  991.  
  992. By default, the DOS 3.XX driver installation procedure installs the 
  993. Symbios Logic MINICAM.SYS driver. This driver does not support 
  994. wide or synchronous negotiation. Since the SDMSNETx.DSK driver 
  995. negotiates for the maximum capabilities supported for each device, it 
  996. is recommended that you load DOSCAM.SYS for optimal 
  997. performance of the NetWare server.
  998.  
  999.  
  1000. Supported DOS Drivers 
  1001.  
  1002. The SDMS 3.XX BIOS currently supports both CAM and ASPI 
  1003. drivers. However, the SDMS NetWare drivers in a 3.XX BIOS 
  1004. environment only support CAM configurations at this time. The 
  1005. following is a list of DOS drivers currently supported by the 
  1006. SDMSNETx.DSK driver:
  1007.  
  1008.  
  1009. DOSCAM.SYS
  1010. For optimal performance, it is strongly recommended that you load 
  1011. the DOSCAM.SYS driver in the CONFIG.SYS file. DOSCAM.SYS, 
  1012. coupled with CDROM.SYS and MSCDEX provides the capability 
  1013. to install the NetWare operating system from CD-ROM. 
  1014. DOSCAM.SYS also provides wide, fast, and synchronous support. 
  1015. This means less overhead for DOS accesses, and increased system 
  1016. performance.
  1017.  
  1018. Note:
  1019. You may load either DOSCAM.SYS, or MINICAM.SYS, 
  1020. but not both.
  1021.  
  1022.  
  1023. MINICAM.SYS
  1024. MINICAM.SYS, coupled with CDROM.SYS and MSCDEX provides 
  1025. the capability to install the NetWare operating system from CD-ROM. 
  1026. It does not provide wide, fast, or synchronous SCSI support, so it is 
  1027. strongly recommended that you not use this driver, or use it only for 
  1028. installation of the NetWare operating system.
  1029.  
  1030. Note:
  1031. You may load either DOSCAM.SYS, or MINICAM.SYS, 
  1032. but not both.
  1033.  
  1034.  
  1035. CDROM.SYS
  1036. To install the NetWare operating system from CD-ROM, you must 
  1037. load this driver with either DOSCAM.SYS or MINICAM.SYS. Once 
  1038. the NetWare operating system installation is complete, CDROM.SYS 
  1039. is not needed. The NetWare drivers have CD-ROM support built in.
  1040.  
  1041.  
  1042. MSCDEX.EXE
  1043. This driver (provided with DOS) is required in conjunction with 
  1044. CDROM.SYS to install NetWare from a CD-ROM. Due to a bug 
  1045. in MSCDEX.EXE, the name assigned to the CD-ROM device not 
  1046. match the base name of any file installed from the CD-ROM. A 
  1047. recommended name to assign to the CD-ROM device is MSCD001.
  1048.  
  1049. Note:
  1050. The NetWare drivers can function independently of any DOS drivers, 
  1051. with the exception of installation of NetWare from CD-ROM. 
  1052. Performance is impacted on DOS accesses, but if memory is 
  1053. premium, this option is available.
  1054.  
  1055.  
  1056. DOS Drivers Not Supported
  1057.  
  1058. The following SDMS DOS drivers are not supported in the 
  1059. NetWare Environment.
  1060.  
  1061. ASPICAM.SYS
  1062. SCSIDISK.SYS
  1063. ASPI8XX.SYS
  1064. SYMCD.SYS
  1065. SYMDISK.SYS
  1066.  
  1067.  
  1068. * When Using No SDMS BIOS *
  1069.  
  1070. The SDMSNETx.DSK driver will operate properly on a system when 
  1071. no SDMS BIOS is present. In this case, DOS must reside on a device 
  1072. which is not connected to a Symbios Logic controller based host 
  1073. adapter. As an example, DOS could reside on an IDE drive.
  1074.  
  1075.